stack: Add gtk_stack_add_child
authorMatthias Clasen <mclasen@redhat.com>
Tue, 15 Sep 2020 22:37:56 +0000 (18:37 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Tue, 15 Sep 2020 22:39:09 +0000 (18:39 -0400)
The name of children is not essential, so add
a way to add children without providing one.

Fixes: #3165
docs/reference/gtk/gtk4-sections.txt
docs/reference/gtk/migrating-3to4.md
gtk/gtkstack.c
gtk/gtkstack.h

index d3986d02d65f61a288fcea2cca713d65dde892f5..62d617d58297517a0d6822d9ab439ade35209cbf 100644 (file)
@@ -5975,6 +5975,7 @@ gtk_stack_page_set_icon_name
 gtk_stack_page_get_child
 GtkStack
 gtk_stack_new
+gtk_stack_add_child
 gtk_stack_add_named
 gtk_stack_add_titled
 gtk_stack_remove
index 8f99501358aa47ca5c83807d0296411a97612c14..59800003b5229bc4b52e890343b15e368849795d 100644 (file)
@@ -606,7 +606,7 @@ The replacements for gtk_container_add() are:
 | GtkListBox      | gtk_list_box_insert() |
 | GtkNotebook     | gtk_notebook_append_page() |
 | GtkPaned        | gtk_paned_set_start_child(), gtk_paned_set_end_child() |
-| GtkStack        | gtk_stack_add_named() |
+| GtkStack        | gtk_stack_add_child() |
 | GtkTextView     | gtk_text_view_add_child_at_anchor(), gtk_text_view_add_overlay() |
 | GtkTreeView     | - |
 
index 75a2fa9e30e5aed30392ea22e865e90a0a890d49..8fd95a39f1860f0f995337cbc8e2dbb1d8315c53 100644 (file)
@@ -1292,6 +1292,25 @@ gtk_stack_add_titled (GtkStack   *stack,
   return gtk_stack_add_internal (stack, child, name, title);
 }
 
+/**
+ * gtk_stack_add_child:
+ * @stack: a #GtkStack
+ * @child: the widget to add
+ *
+ * Adds a child to @stack.
+ *
+ * Returns: (transfer none): the #GtkStackPage for @child
+ */
+GtkStackPage *
+gtk_stack_add_child (GtkStack   *stack,
+                     GtkWidget  *child)
+{
+  g_return_val_if_fail (GTK_IS_STACK (stack), NULL);
+  g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
+
+  return gtk_stack_add_internal (stack, child, NULL, NULL);
+}
+
 /**
  * gtk_stack_add_named:
  * @stack: a #GtkStack
index 6253890aa58cd9b45ccf35ea38660ac8b4a16da4..cf506b49fb4d0107c734ec7f651f8582fa394f2c 100644 (file)
@@ -113,6 +113,9 @@ GType                  gtk_stack_get_type                (void) G_GNUC_CONST;
 GDK_AVAILABLE_IN_ALL
 GtkWidget *            gtk_stack_new                     (void);
 GDK_AVAILABLE_IN_ALL
+GtkStackPage *         gtk_stack_add_child               (GtkStack               *stack,
+                                                          GtkWidget              *child);
+GDK_AVAILABLE_IN_ALL
 GtkStackPage *         gtk_stack_add_named               (GtkStack               *stack,
                                                           GtkWidget              *child,
                                                           const char             *name);